package com.ruoyi.common.core.service;

import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.extension.service.IService;

import java.io.Serializable;
import java.util.Collection;
import java.util.List;

/**
 * TODO 自定义 继承此接口，实现通用的增删改查功能
 * @param <T>
 */
public interface IBaseService<T> extends IService<T> {

    /**
     * 通用的查询:可分页/不分页/只查询总数/分页查询但不进行count查询
     *
     * @param queryWrapper 查询条件
     * @param queryParam   查询参数:
     *                     <p>1:currentPage或pageSize为null或者为0不分页查询列表,执行list(Wrapper<T> queryWrapper)，返回IPage<p/>
     *                     <p>2:currentPage或pageSize小于0,查询总记录条数,执行count(Wrapper<T> queryWrapper)，返回IPage.total<p/>
     *                     <p>3:searchCount是否进行count查询</p>
     *                     <p>4:currentPage和pageSize大于0,分页查询,执行page(E page, Wrapper<T> queryWrapper),返回IPage</p>
     * @return
     */

    /**
     * 根据 ID 查询
     *
     * @param id 主键id
     * @return 无数据抛异常
     */
    T getByIdOrThrow(Serializable id);

    T getByIdOrThrow(Serializable id, String errorMsgTemplate, Object... params);

    /**
     * 根据 ID 查询,复制Bean对象属性
     *
     * @param id               主键id
     * @param clazz            copy的class
     * @param ignoreProperties 忽略的属性
     * @return 无数据抛异常
     */
    T getByIdOrThrow(Serializable id, Class<T> clazz, String... ignoreProperties);

    /**
     * 根据 ID 查询
     *
     * @param id    主键id
     * @param clazz 被构造的类
     * @return 无数据返回构造后的对象
     */
    T getByIdOrNewInstance(Serializable id, Class<T> clazz);

    /**
     * 查询一条记录  LIMIT 1
     *
     * @param queryWrapper
     * @return
     */
    default T getAny(LambdaQueryWrapper<T> queryWrapper) {
        return getOne(queryWrapper.last("LIMIT 1"));
    }

    /**
     * 查询（根据ID 批量查询）
     *
     * @param ids 主键di集合
     * @return 无数据抛异常
     */
    List<T> listByIdsOrThrow(Collection<? extends Serializable> ids);

}
